Implementing Campaign Manager - System Management


Adding Additional Engine Servers

Add additional Engine servers to an existing Campaign Manager installation.

Procedure

  1. Ensure that the new Engine server complies with the pre-requisites for Engine servers described in the Installation Guide or Upgrade Guide depending on whether you have installed or upgraded to Campaign Manager.
  2. A standalone Engine installer (Engine.exe) can be taken from the CM Deployer 'Integrations' subfolder and installed onto the new server. The default install location for program files is "C:\Program Files\Engine" and Projectbase is "C:\ProgramData\Engine".

To override these defaults run the Engine installer from an elevated command prompt with the following parameters:

Engine.exe InstallProgramFolder=”e:\Program Files\Engine” InstallDataFolder=”e:\Engine Data”
Note: Parameter names are case sensitive. Path values must be enclosed in double quotes. Do not include trailing '\' characters at the end of path names for example. "C:\Program Files\Engine\"
  1. Copy the installation folder (currently called Alterian and found in \Program Files) from an existing Engine server to the new one. If the install drive on both the servers is the same, i.e. 'C:', then no updates to the Services config files are required, if they are different the following config files will need updating:

\Program Files\Alterian\Alchemy\AlchemyEngineService \AlchemyEngineService.exe.config

\Program Files\Alterian\AlertLogger\Alterian.Common.AlertLogger.exe.config

\Program Files\Alterian\AlertLogger\Alterian.Common.AlertNotifier.exe.config

  1. Share the \Program Files\Alterian\Alchemy folder.

The share name will read '\\Server Name\Alchemy'

  1. Install the services Alchemy AlertLogger, AlchemyAlertNotifier and Alchemy EngineService.

Example script for using sc create to do this (from a cmd line) is:

sc create AlertLoggerService start= auto binPath= "c:\program files\alterian\alchemy\alertlogger\alterian.common.alertlogger.exe" displayname= "Alchemy AlertLogger" obj= domain\services-account password= password
  1. Run the following commands to register the dlls:

Regsvr32 "C:\Program Files\Alterian\Alchemy\PauseResume\EMTools.dll"

Regsvr32 "C:\Program Files\Alterian\Alchemy\PauseResume\APIClient.dll"

Regsvr32 "C:\Program Files\Alterian\Alchemy\PauseResume\AltEngineCampaign.dll"

Regsvr32 "C:\Program Files\Alterian\Alchemy\EngineFiles\EngineMutex.dll"

  1. Run the following commands to register additional dlls:

From an Engine server command prompt, change directory to the CM PauseResume folder (e.g. C:\Program Files\Alterian\Alchemy\PauseResume)

Regasm.exe PauseResumeCampaignsApp.exe

Regasm.exe AttributionEngineCommandLine.exe

  1. Start the AlertLogger, AlertNotifier and AlchemyEngineService services.
  2. To ensure that future upgrades will include this additional Engine server, run the following SQL commands:

INSERT INTO [almain].[AL].[processindex]

([appid] , [hostname] , [alertfilelocation] , [heartbeat] , [enabled] , [heartbeatthreshold] , [networkPath]) VALUES

((select id from [almain].[AL].[appindex]where name = 'AlertLogger')

,'NEW ENGINE SERVER NAME'

,'

NEW ENGINE SERVER NAME\Alchemy\AlertLogger\Alerts\AlertLogger.txt'

,NULL

,1

,30

,'

NEW ENGINE SERVER NAME\Alchemy\AlertLogger')

INSERT INTO [almain].[AL].[processindex]

([appid] , [hostname] , [alertfilelocation] , [heartbeat] , [enabled] , [heartbeatthreshold] , [networkPath]) VALUES

((select id from [almain].[AL].[appindex]where name = 'AlertNotifier')

,'NEW ENGINE SERVER NAME'

,'

NEW ENGINE SERVER NAME\Alchemy\AlertNotifier\Alerts\AlertNotifier.txt'

,NULL

,1

,60

,'

NEW ENGINE SERVER NAME\Alchemy\AlertNotifier')

INSERT INTO [almain].[AL].[processindex]

([appid] , [hostname] , [alertfilelocation] , [heartbeat] , [enabled] , [heartbeatthreshold] , [networkPath])

VALUES

((select id from [almain].[AL].[appindex]where name = 'Alchemy Engine Service')

,'NEW ENGINE SERVER NAME'

,'

NEW ENGINE SERVER NAME\Alchemy\AlchemyEngineService\Alerts\AlchemyEngineService.txt' ,NULL

,1

,60

,'

NEW ENGINE SERVER NAME\Alchemy\AlchemyEngineService')

  1. Add the following lines to c:\Program Files\Engine\ETL\loaderserver.ini:

EMTools.details

APIClient.details

  1. Connect the Engine server's Projects as datasources.

For more information on datasources, see Datasource management.

  Online & Instructor-Led Courses | Training Videos | Webinar Recordings
© Alterian. All Rights Reserved. | Privacy Policy | Legal Notice